Module

table/utils/ui/table-properties

@ckeditor/ckeditor5-table/src/utils/ui/table-properties

module

Filtering

Constants

  • defaultColors

    A default color palette used by various user interfaces related to tables, for instance, by TableCellPropertiesUI or TablePropertiesUI.

    The color palette follows the table color configuration format and contains the following color definitions:

    const defaultColors = [
    	{
    		color: 'hsl(0, 0%, 0%)',
    		label: 'Black'
    	},
    	{
    		color: 'hsl(0, 0%, 30%)',
    		label: 'Dim grey'
    	},
    	{
    		color: 'hsl(0, 0%, 60%)',
    		label: 'Grey'
    	},
    	{
    		color: 'hsl(0, 0%, 90%)',
    		label: 'Light grey'
    	},
    	{
    		color: 'hsl(0, 0%, 100%)',
    		label: 'White',
    		hasBorder: true
    	},
    	{
    		color: 'hsl(0, 75%, 60%)',
    		label: 'Red'
    	},
    	{
    		color: 'hsl(30, 75%, 60%)',
    		label: 'Orange'
    	},
    	{
    		color: 'hsl(60, 75%, 60%)',
    		label: 'Yellow'
    	},
    	{
    		color: 'hsl(90, 75%, 60%)',
    		label: 'Light green'
    	},
    	{
    		color: 'hsl(120, 75%, 60%)',
    		label: 'Green'
    	},
    	{
    		color: 'hsl(150, 75%, 60%)',
    		label: 'Aquamarine'
    	},
    	{
    		color: 'hsl(180, 75%, 60%)',
    		label: 'Turquoise'
    	},
    	{
    		color: 'hsl(210, 75%, 60%)',
    		label: 'Light blue'
    	},
    	{
    		color: 'hsl(240, 75%, 60%)',
    		label: 'Blue'
    	},
    	{
    		color: 'hsl(270, 75%, 60%)',
    		label: 'Purple'
    	}
    ];

Functions

  • colorFieldValidator( value ) → Boolean

    Returns true when the passed value is an empty string or a valid CSS color expression. Otherwise, false is returned.

    See isColor.

    Parameters

    value : String

    Returns

    Boolean
  • fillToolbar( options = { options.view, options.icons, options.toolbar }, labels, propertyName, nameToValue )

    A helper that fills a toolbar with buttons that:

    • have some labels,
    • have some icons,
    • set a certain UI view property value upon execution.

    Parameters

    options : Object
    Properties
    options.view : TableCellPropertiesView | TablePropertiesView
    options.icons : Array.<String>
    options.toolbar : ToolbarView
    labels : Object.<String, String>
    propertyName : String
    nameToValue : function

    A function that maps a button name to a value. By default names are the same as values.

  • getBorderStyleDefinitions( view, defaultStyle ) → Iterable.<ListDropdownItemDefinition>

    Generates item definitions for a UI dropdown that allows changing the border style of a table or a table cell.

    Parameters

    view : TableCellPropertiesView | TablePropertiesView
    defaultStyle : String

    The default border.

    Returns

    Iterable.<ListDropdownItemDefinition>
  • getBorderStyleLabels( t ) → Object.<String, String>

    Returns an object containing pairs of CSS border style values and their localized UI labels. Used by TableCellPropertiesView and TablePropertiesView.

    Parameters

    t : Locale#t

    The "t" function provided by the editor that is used to localize strings.

    Returns

    Object.<String, String>
  • getLabeledColorInputCreator( options, options.colorConfig, options.columns, [ options.defaultColorValue ] ) → function

    private

    Returns a creator for a color input with a label.

    For given options, it returns a function that creates an instance of a color input logically related to a labeled view in the DOM.

    The helper does the following:

    • It sets the color input id and ariaDescribedById attributes.
    • It binds the color input isReadOnly to the labeled view.
    • It binds the color input hasError to the labeled view.
    • It enables a logic that cleans up the error when the user starts typing in the color input.

    Usage:

    const colorInputCreator = getLabeledColorInputCreator( {
    	colorConfig: [ ... ],
    	columns: 3,
    } );
    
    const labeledInputView = new LabeledFieldView( locale, colorInputCreator );
    console.log( labeledInputView.view ); // A color input instance.

    Parameters

    options

    Color input options.

    options.colorConfig : TableColorConfig

    The configuration of the color palette displayed in the input's dropdown.

    options.columns : Number

    The configuration of the number of columns the color palette consists of in the input's dropdown.

    [ options.defaultColorValue ] : String

    If specified, the color input view will replace the "Remove color" button with the "Restore default" button. Instead of clearing the input field, the default color value will be set.

    Returns

    function
  • getLocalizedColorErrorText( t ) → String

    Returns a localized error string that can be displayed next to color (background, border) fields that have an invalid value.

    Parameters

    t : Locale#t

    The "t" function provided by the editor that is used to localize strings.

    Returns

    String
  • getLocalizedLengthErrorText( t ) → String

    Returns a localized error string that can be displayed next to length (padding, border width) fields that have an invalid value.

    Parameters

    t : Locale#t

    The "t" function provided by the editor that is used to localize strings.

    Returns

    String
  • lengthFieldValidator( value ) → Boolean

    Returns true when the passed value is an empty string, a number without a unit or a valid CSS length expression. Otherwise, false is returned.

    See isLength. See isPercentage.

    Parameters

    value : String

    Returns

    Boolean
  • lineWidthFieldValidator( value ) → Boolean

    Returns true when the passed value is an empty string, a number without a unit or a valid CSS length expression. Otherwise, false is returned.

    See isLength.

    Parameters

    value : String

    Returns

    Boolean