README

Kirki自定义框架的滑块控件包。

目录

• kirki-framework/control-slider
  • 目录
  • 安装
  • 使用方法
    • 使用简化API
    • 使用自定义API
  • 开发
  • 许可证

安装

首先，使用composer安装此包

composer require kirki-framework/control-slider

然后确保您已包含自动加载器

require_once "your/path/to/vendor/autoload.php";

使用方法

可以使用Kirki API或WordPress自定义API使用此控件。

使用简化API

new \Kirki\Field\Slider(
	[
		'settings'    => 'your_control_setting_id',
		'label'       => esc_html__( 'Your Control Label', 'your-text-domain' ),
		'description' => esc_html__( 'Your control description.', 'your-text-domain' ),
		'section'     => 'your_section_id',
		'default'     => 5,
		'choices'     => [
			'min'  => 0,
			'max'  => 100,
			'step' => 1,
		],
	]
);

使用自定义API

/**
 * Register customizer settings and controls.
 *
 * @param \WP_Customize_Manager $wp_customize The Customizer object.
 */
function your_customize_register_function( $wp_customize ) {

	// Add setting.
	$wp_customize->add_setting(
		'your_control_setting_id',
		[
			'type'       => 'theme_mod', // Or 'option'.
			'capability' => 'edit_theme_options',
			'default'    => 5,
			'transport'  => 'postMessage', // Or 'refresh'.
			'sanitize'   => 'intval', // Or 'absint' or other int sanitization.
		]
	);

	// Add control.
	$wp_customize->add_control(
		new \Kirki\Control\Slider(
			$wp_customize,
			'your_control_setting_id',
			[
				'label'       => esc_html__( 'Your Control Label', 'your-text-domain' ),
				'description' => esc_html__( 'Your control description.', 'your-text-domain' ),
				'section'     => 'your_section_id',
				'choices'     => [
					'min'  => 0,
					'max'  => 100,
					'step' => 1,
				],
			]
		)
	);

	// Add more settings...

	// Add more controls...

}
add_action( 'customize_register', 'your_customize_register_function' );

开发

如果您想修改此控件，可以编辑位于src文件夹中的JS文件。

• 如果您尚未安装包，请运行npm install
• 编辑完成后，运行npm run build

许可证

MIT许可证