The Dashicons control allows you to select an available icons from the WordPress Dashicons iconfont.
The returned value is a string and does not contain the dashicons dashicons- prefix.
Example
new \Kirki\Field\Dashicons(
[
'settings' => 'dashicons_setting',
'label' => esc_html__( 'Dashicons Control', 'kirki' ),
'section' => 'section_id',
'default' => 'menu',
'priority' => 10,
]
);new \Kirki\Field\Dashicons(
[
'settings' => 'dashicons_setting_2',
'label' => esc_html__( 'Dashicons Control', 'kirki' ),
'description' => esc_html__( 'Display only a limited selection of Dashicons.', 'kirki' ),
'section' => 'section_id',
'default' => 'menu',
'priority' => 10,
'choices' => [
'menu',
'admin-site',
'dashboard',
'admin-post',
'admin-media',
'admin-links',
'admin-page',
],
]
);Usage
<?php $icon = get_theme_mod( 'dashicons_setting', 'menu' ); ?>
<span class="dashicons dashicons-<?php echo esc_attr( $icon ); ?>"></span>