Advanced Custom Fields 入门-字段设置

概述

每个字段都包含用于确定加载和保存数据的位置和方式的设置。编辑字段组时可以自定义这些设置。所有字段共享一些通用设置,但也为每种字段类型提供独特的设置。通过阅读有关字段类型的更多信息,可以找到这些独特的设置。下面是显示文本字段的可用字段设置的屏幕截图。

常用设置

名称 描述
字段标签 这是输入值时出现在编辑页面上的标签,必需的,可以是中文或者英文。
字段名称 用于从数据库保存和加载数据的名称。此名称必须是一个英文单词,不允许有空格、必填。
字段类型 字段的类型会改变可用的设置、输入数据时的界面以及从数据库返回的值,必填。
说明 输入值时,显示给内容作者的说明文字,在提交数据时显示。
必填 强制输入设置,如果不填写,将提示填写字段。
条件逻辑 启用后,将出现更多设置来自定义确定当前字段是否可见的逻辑。可以创建条件逻辑组以允许多个和/或语句。可用的“切换”字段仅限于选择、复选框、真/假、单选类型的字段。
包装器属性 这些属性将用于为该字段创建包装 DOM 元素。在 v5.0.0 中添加

定制

在“编辑字段组”用户界面之外,可以通过acf/load_field 过滤器修改字段的设置。此过滤器公开$field每个字段的设置数组,并允许自定义所有设置。

此示例显示如何通过此过滤器修改特定字段(称为“事件”)以自定义 UI 不可用的设置。

function my_acf_load_field( $field ) {
	
	// 要求
	$field['required'] = true;
	
	
	//自定义说明图标
	$field['instructions'] = '<i class="help" title="Instructions here"></i>';
	
	
	// 自定义包装元素
	$field['wrapper']['id'] = 'my-custom-id';
	$field['wrapper']['data-jsify'] = '123';
	$field['wrapper']['title'] = 'Text here';
	
	
	// 返回
	return $field;
    
}

add_filter('acf/load_field/name=event', 'my_acf_load_field');
<!-- 事件字段标记 -->
<div id="my-custom-id" class="acf-field acf-field-text acf-field-5927ba4cecf19" data-jsify="123" title="Text here">
	<div class="acf-label">
		<label for="menu-item-acf-6363-field_5927ba4cecf19">
			Icon <i class="help" title="Instructions here"></i> <span class="acf-required">*</span>
		</label>
	</div>
	<div class="acf-input">
		...
	</div>
</div>

 

发表评论

您的电子邮箱地址不会被公开。 必填项已用*标注

上一篇

Advanced Custom Fields 入门-创建字段组

下一篇

Advanced Custom Fields 入门-在主题中调用值

相关文章