SP へUserCustomActionCollection.add 方法 (sp.js)
コレクションに新しいSP へUserCustomAction オブジェクト (sp.js)カスタム アクションを追加します。
**適用対象:**apps for SharePoint | SharePoint Foundation 2013 | SharePoint Server 2013
SP.UserCustomActionCollection.add()
戻り値
[Type]: SP.UserCustomAction
例
次の例では、現在の Web サイトのサイトの操作] メニューに新しいメニュー項目を追加するアプリケーション ページの [入力] ボタンを作成します。
<asp:Content ID="Main" ContentPlaceHolderID="PlaceHolderMain" runat="server">
<script type="text/ecmascript" language="ecmascript">
function runCode() {
var clientContext = new SP.ClientContext();
var site = clientContext.get_web();
var UserCustomActions = site.get_userCustomActions();
var newUserCustomAction = UserCustomActions.add();
newUserCustomAction.set_location('Microsoft.SharePoint.StandardMenu');
newUserCustomAction.set_group('SiteActions');
newUserCustomAction.set_sequence(1000);
newUserCustomAction.set_title('New Menu Item');
newUserCustomAction.set_imageUrl('/_layouts/images/myIcon.jpg');
newUserCustomAction.set_description('Menu item added via ECMAScript');
newUserCustomAction.set_url('/_layouts/create.aspx');
newUserCustomAction.update();
clientContext.executeQueryAsync(Function.createDelegate(this, this.onQuerySucceeded), Function.createDelegate(this, this.onQueryFailed));
}
function onQuerySucceeded(sender, args) {
alert('New menu item added to Site Actions menu.\n\nTo view the new menu item, refresh the page.');
}
function onQueryFailed(sender, args) {
alert('Request failed. ' + args.get_message() + '\n' + args.get_stackTrace());
}
</script>
<input id="Button1" type="button" value="Run Code" onclick="runCode()" />
</asp:Content>
他のリソースのエンドポイント
ユーザーのカスタム アクションを作成するには、[ UserCustomActionsエンドポイントにPOST要求を送信します。詳細については、 UserCustomActionCollection リソースを参照してください。